---
sidebar_position: 1.5
id: "waveai"
title: "Wave AI"
---

import { Kbd } from "@site/src/components/kbd";
import { PlatformProvider, PlatformSelectorButton } from "@site/src/components/platformcontext";

<PlatformProvider>

<PlatformSelectorButton />

<br/><br/>
Context-aware terminal assistant with access to terminal output, widgets, and filesystem.

## Keyboard Shortcuts

| Shortcut | Action |
|----------|--------|
| <Kbd k="Cmd:Shift:a"/> | Toggle AI panel |
| <Kbd k="Ctrl:Shift:0"/> | Focus AI input |
| <Kbd k="Cmd:k"/> | Clear chat / start new |
| <Kbd k="Enter"/> | Send message |
| <Kbd k="Shift:Enter"/> | New line |

## Widget Context Toggle

Controls AI's access to your workspace:

**ON**: AI can read terminal output, capture widget screenshots, access files/directories (with approval), navigate web widgets, and use custom widget tools. Use for debugging, code analysis, and workspace tasks.

**OFF**: AI only sees your messages and attached files. Standard chat mode for general questions.

## File Attachments

Drag files onto the AI panel to attach:

| Type | Formats | Size Limit | Notes |
|------|---------|------------|-------|
| Images | JPEG, PNG, GIF, WebP, SVG | 10 MB | Auto-resized to 4096px max, converted to WebP |
| PDFs | `.pdf` | 5 MB | Text extraction for analysis |
| Text/Code | `.js`, `.ts`, `.py`, `.go`, `.md`, `.json`, `.yaml`, etc. | 200 KB | All common languages and configs |

## CLI Integration

Use `wsh ai` to send files and prompts from the command line:

```bash
git diff | wsh ai -                          # Pipe to AI
wsh ai main.go -m "find bugs"                # Attach files with message
wsh ai $(tail -n 500 my.log) -m "review" -s  # Auto-submit with output
```

Supports text files, images, PDFs, and directories. Use `-n` for new chat, `-s` to auto-submit.

## AI Tools (Widget Context Enabled)

### Terminal
- **Read Terminal Output**: Fetches scrollback from terminal widgets, supports line ranges

### File System
- **Read Files**: Reads text files with line range support (requires approval)
- **List Directories**: Returns file info, sizes, permissions, timestamps (requires approval)
- **Write Text Files**: Create or modify files with diff preview and approval (requires approval)

### Web
- **Navigate Web**: Changes URLs in web browser widgets

### All Widgets
- **Capture Screenshots**: Takes screenshots of any widget for visual analysis

:::warning Security
File system operations require explicit approval. You control all file access.
:::

## Privacy

- Messages are proxied through the Wave Cloud AI service (powered by OpenAI's APIs). Please refer to OpenAI's privacy policy for details on how they handle your data.
- Wave does not store your chats, attachments, or use them for training
- Usage counters included in anonymous telemetry
- File access requires explicit approval

:::info Under Active Development
Wave AI is in active beta with included AI credits while we refine the experience. BYOK will be available once we've stabilized core features and gathered feedback on what works best. Share feedback in our [Discord](https://discord.gg/XfvZ334gwU).

**Coming Soon:**
- **Remote File Access**: Read files on SSH-connected systems
- **Command Execution**: Run terminal commands with approval
- **Web Content**: Extract text from web pages (currently screenshots only)
:::

</PlatformProvider>